GtkApplication: doc improvement

diff --git a/gtk/gtkapplication.c b/gtk/gtkapplication.c
index f80c8306de4f2f93dc425b0f4ea90a187b5a7598..cd5482a9dcd89793d7dc6a2688f2319471db04d9 100644 (file)
--- a/gtk/gtkapplication.c
+++ b/gtk/gtkapplication.c
@@ -50,9 +50,12 @@
  * a one-size-fits-all application model.
  *
  * Currently, GtkApplication handles GTK+ initialization, application
- * uniqueness, provides some basic scriptability by exporting 'actions',
- * and manages a list of toplevel windows whose life-cycle is automatically
- * tied to the life-cycle of your application.
+ * uniqueness, provides some basic scriptability and desktop shell integration
+ * by exporting actions and menus and manages a list of toplevel windows whose
+ * life-cycle is automatically tied to the life-cycle of your application.
+ *
+ * While GtkApplication works fine with plain #GtkWindows, it is recommended
+ * to use it together with #GtkApplicationWindow.
  *
  * <example id="gtkapplication"><title>A simple application</title>
  * <programlisting>